package com.tidy.seed.admin.system.service;

import com.tidy.seed.admin.system.vo.file.upload.FileUploadVO;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;
import java.util.Map;

/**
 * 系统模块 - 文件上传服务接口
 */
public interface FileUploadService {

    /**
     * 单文件上传
     *
     * @param file 上传的文件
     * @return 上传结果（文件名、路径等）
     * @throws Exception 上传失败时抛出异常
     */
    FileUploadVO uploadSingle(MultipartFile file, String dir) throws Exception;

    /**
     * 多文件上传
     *
     * @param files 上传的文件列表
     * @return 上传结果（包含所有文件的信息）
     * @throws Exception 上传失败时抛出异常
     */
    Map<String, Object> uploadMultiple(List<MultipartFile> files, String dir) throws Exception;

    /**
     * 逐级查询目录
     *
     * @param currentPath 当前目录路径（相对于根目录）
     * @return 目录信息（当前路径、父路径、文件列表）
     * @throws Exception 路径不合法时抛出异常
     */
    Map<String, Object> listDir(String currentPath) throws Exception;

    void deletePath(String targetPath) throws Exception;
    void createDir(String dirPath) throws Exception;

}